WordPress 502 Bad Gateway Hatası Nasıl Çözülür? (%100 Çözüm)

İnternet sitenizi ziyaret ettiğinizde ya da yönetim paneline girmeye çalıştığınızda beyaz bir sayfada aniden beliren WordPress 502 Bad Gateway hatası, webmasterların ve sunucu yöneticilerinin en sık karşılaştığı en kritik kriz anlarından biridir. Ziyaretçilerin doğrudan geri dönmesine, dönüşüm kayıplarına ve Google arama motoru botlarının tarama bütçesini tüketerek sıralama kayıplarına yol açan bu durum, basit bir sayfa yenilemeyle düzelmeyen çekirdek bir iletişim kopukluğunu temsil eder.

Kullanıcıların ve site sahiplerinin büyük çoğunluğu bu hatayla karşılaştığında tarayıcı önbelleğini temizlemek ya da modemi kapatıp açmak gibi yüzeysel adımlara yönelir. Oysa gerçekte WordPress 502 bad gateway uyarısı, istemci ile web sunucusu (Nginx, Apache) ve arka uç uygulama motoru (PHP-FPM, LiteSpeed, MySQL) arasındaki ağ geçidi iletişim protokolünün kırıldığını haber veren bir HTTP 5xx durum kodudur. Bu kapsamlı teknik rehberde, 502 Bad Gateway hatasının gerçek kök nedenlerini analiz edecek; sunucu mimarisi, PHP havuz yönetimi, Nginx FastCGI parametreleri ve Cloudflare ayarları üzerinden sorunu adım adım %100 kesin çözüme kavuşturacağız.

WordPress 502 Bad Gateway Hatası Nedir ve Neden Meydana Gelir?

Modern web mimarisinde internet siteleri tek parça monolitik bir blok olarak çalışmaz. Ziyaretçi tarayıcısından çıkan bir istek, önce ters vekil sunucuya (Reverse Proxy – Nginx, Apache ya da Cloudflare Edge) ulaşır. Bu ters vekil sunucu, gelen HTTP/HTTPS isteğini karşılar ve statik dosyaları (görseller, CSS, JavaScript) doğrudan sunarken dinamik PHP kodlarını yorumlamak üzere arka uçta (Upstream / Backend) çalışan uygulama sunucusuna yani PHP-FPM (FastCGI Process Manager) veya LiteSpeed motoruna devreder.

Ters vekil sunucu bir ağ geçidi (Gateway) gibi davrandığı sırada, arkasındaki uygulama motorundan geçersiz, anlamsız ya da bozuk bir yanıt aldığında istemciye HTTP 502 Bad Gateway durum kodunu döner. Bu durum, sunucunun fiziksel olarak açık olduğunu ancak yazılımsal iletişim zincirinde bir halkanın tamamen koptuğunu gösterir.

Sunucu protokollerinde sıklıkla birbirine karıştırılan üç temel 5xx hata kodunu birbirinden ayırt etmek, teşhis sürecini saatlerce kısaltır:

• 500 Internal Server Error: Genellikle PHP betiğinin sözdizimi (syntax) hatası vermesi, .htaccess bozulması veya yakalanmamış kritik bir fatal error durumunda üretilir. İstek PHP motoruna ulaşmış ancak kod çalışırken patlamıştır. Web sitenizdeki altyapı açıklarını ve riskleri WordPress güvenlik açıkları ve web sitesi koruma rehberi üzerinden inceleyebilirsiniz.
• 502 Bad Gateway: Ön uçtaki web sunucusu (Nginx), arka uçtaki PHP işleyicisine ulaşmış fakat oradan geçersiz, eksik veya başlıkları bozuk (invalid headers) bir yanıt almıştır. Çoğunlukla PHP havuzunun çökmesi ya da bellek aşımı kaynaklıdır.
• 504 Gateway Timeout: Web sunucusu arka uçtaki servise isteği göndermiş, ancak belirlenen zaman aşımı süresi (örneğin 60 saniye) boyunca arkadan hiçbir yanıt gelmemiştir. Arka plandaki uzun süren veri tabanı sorguları veya takılı kalan API çağrıları buna sebep olur. Performans darboğazlarını çözmek adına veri tabanı indeksleri ve B-Tree mimarisi rehberimiz yüksek sorgu yüklerini hafifletmede kritik rol oynar.

Cloudflare 502 Bad Gateway: Host Error vs Origin Server Farkı

Eğer web sitenizin önünde Cloudflare gibi bir CDN ve Web Uygulama Güvenlik Duvarı (WAF) servisi bulunuyorsa, WordPress 502 bad gateway hatası iki farklı biçimde ekrana yansır. Hatayı doğru teşhis edebilmek için ekranın tasarımına ve hata başlığına dikkatle bakmanız gerekir:

1. Cloudflare Markalı “Bad Gateway: Host Error” (502): Bu ekranda Cloudflare logosu yer alır ve hata doğrudan Cloudflare kenar (edge) sunucuları tarafından üretilmiştir. Bu durum, Cloudflare sunucularının orijinal ana makinenize (Origin Server) TCP/IP el sıkışmasıyla bağlanamadığını, SSL/TLS sertifika eşleşmesinin reddedildiğini ya da hosting sağlayıcınızın ağında bir kesinti olduğunu gösterir.

2. Beyaz Ekranda Sade “502 Bad Gateway nginx”: Ekranda Cloudflare tasarımı yerine sade, gri-siyah bir metinle web sunucusunun adı yazıyorsa, istek Cloudflare üzerinden geçmiş ve orijinal sunucunuza sorunsuz ulaşmıştır. Ancak orijinal sunucunuzdaki Nginx veya Apache, kendi içindeki PHP motorundan bozuk yanıt aldığı için bu hatayı Cloudflare’a fırlatmıştır.

Dolayısıyla sade Nginx 502 hatası alıyorsanız Cloudflare ayarlarıyla oynamak yerine doğrudan sunucunuzun terminaline, PHP yapılandırmasına ve WordPress dosyalarına odaklanmanız gerekir.

WordPress 502 Bad Gateway Hatasına Yol Açan 6 Temel Neden

WordPress ekosisteminde ortaya çıkan 502 hataları rastgele oluşmaz. Yüzlerce canlı sunucu vakasının incelenmesi sonucunda, bu problemin arkasındaki 6 ana neden şu şekilde listelenmiştir:

• 1. PHP-FPM İşçi Süreçlerinin (Worker Processes) Tükenmesi: Sitenize anlık yoğun trafik geldiğinde ya da kaynak tüketen bir bot ordusu saldırdığında, PHP-FPM havuzundaki tüm işçi süreçler (pm.max_children) meşgul duruma düşer. Yeni gelen istekleri karşılayacak boş işçi kalmadığında kuyruk dolar ve Nginx 502 Bad Gateway hatası döndürür.
• 2. PHP Bellek Limitinin (Memory Limit) Aşılması: Ağır eklentiler (WooCommerce, Elementor, WPML, yedekleme araçları) işlem yaparken ayrılan bellek tavanına (örneğin 128MB veya 256MB) çarptığında PHP sessizce ölür (Fatal Error: Allowed memory size exhausted). Bellek yönetimi prensiplerini daha derin anlamak için yüksek RAM kullanımı ve fiziksel bellek mimarisi analizimize göz atabilirsiniz.
• 3. Nginx ile PHP-FPM Arasındaki Soket / Port Uyuşmazlığı: Web sunucusu yapılandırmasında fastcgi_pass parametresi UNIX soketine (unix:/var/run/php/php8.2-fpm.sock) yönlendirilmişken, PHP-FPM servisinin TCP portu (127.0.0.1:9000) üzerinde dinlemesi veya soket dosyasının izinlerinin bozulması iletişimi tamamen keser.
• 4. Hatalı Tema ve Eklenti Kodları (Sonsuz Döngüler): Yeni güncellenen bir eklentinin veri tabanı ile sonsuz döngüye girmesi ya da harici bir API servisine (ödeme ağ geçidi, lisans sunucusu) bağlanmaya çalışırken kilitlenmesi PHP sürecini zaman aşımına uğratır.
• 5. Güvenlik Duvarı (WAF) ve Sunucu İçi İletişim Engelleri: Sunucuda kurulu olan Fail2ban, ModSecurity, CSF Firewall ya da harici WAF çözümlerinin, sunucunun yerel döngü (localhost) IP adreslerini yanlışlıkla engelleyerek Nginx ile FastCGI arasındaki trafiği filtrelemesi.
• 6. Veri Tabanı Kilitlenmeleri (Database Deadlocks): MySQL / MariaDB sunucusunda InnoDB kilitlenmeleri yaşandığında PHP betiği yanıt üretemez ve bellek havuzu dolup taşarak çöker.

Sunucu Loglarını İnceleme: Nginx ve PHP-FPM Hata Kayıtları ile Teşhis

Karanlıkta el feneri olmadan yürümek yerine, sorunun kaynağını dakikalar içinde tespit etmenin tek profesyonel yolu sunucu günlük kayıtlarını (log) okumaktır. Sunucunuza güvenli bir SSH bağlantısı kurduktan sonra iki temel log dosyasını canlı olarak incelemeniz gerekir. Sunucu erişim protokollerinizi güçlendirmek için SSH anahtar doğrulaması ile sunucu güvenliği adımlarını uygulamanız tavsiye edilir.

Terminal ekranında aşağıdaki komutları çalıştırarak son hata dökümlerini filtreleyin:

# Nginx hata kayıtlarını canlı izleyin
tail -f -n 50 /var/log/nginx/error.log

# PHP-FPM hata kayıtlarını inceleyin (Sürümünüze göre 8.1, 8.2 veya 8.3)
tail -f -n 50 /var/log/php8.2-fpm.log

Bu log dosyalarında karşılaşacağınız en yaygın üç hata satırı ve çözümleri şunlardır:

• connect() to unix:/var/run/php/php8.2-fpm.sock failed (111: Connection refused): Bu hata, PHP-FPM servisinin çöktüğünü ya da hiç çalışmadığını gösterir. Doğrudan PHP servisinin yeniden başlatılması gerekir.
• upstream sent too big header while reading response header from upstream: FastCGI yanıt başlıklarının Nginx tampon (buffer) boyutunu aştığını belirtir. Nginx yapılandırmasında fastcgi_buffer_size değerinin artırılması gerekir.
• WARNING: [pool www] server reached pm.max_children setting (5), consider raising it: Havuzdaki işçi sayısının anlık isteklere yetişemediğini ve yeni isteklerin kuyrukta düşürüldüğünü gösterir. Havuz parametreleri optimize edilmelidir.

Adım Adım WordPress 502 Bad Gateway Hatası Çözüm Yöntemleri

Aşağıda yer alan 5 adımlı karar ve onarım matrisi, sisteminizi adım adım analiz ederek sitenizi dakikalar içinde tekrar ayağa kaldırmanızı sağlar:

Adım 1: PHP-FPM ve Nginx Servislerini Yeniden Başlatma

Eğer bir bellek sızıntısı veya kilitlenme nedeniyle PHP-FPM donmuşsa, servisleri sırasıyla yeniden başlatmak kilitlenen süreçleri temizler ve sitenin hızla açılmasını sağlar. Linux terminalinde şu komutları sırasıyla uygulayın:

# PHP-FPM servisinin durumunu kontrol edin
sudo systemctl status php8.2-fpm

# Servisi yeniden başlatın
sudo systemctl restart php8.2-fpm

# Nginx web sunucusunu yeniden başlatın
sudo systemctl restart nginx

Servisler yeniden başladıktan sonra sitenizi gizli sekmede test edin. Eğer site açıldıysa ancak birkaç saat sonra tekrar 502 hatası veriyorsa, sorun arka planda bellek tüketen bir eklenti veya yetersiz havuz yapılandırmasıdır.

Adım 2: wp-config.php Üzerinden PHP Bellek Limitini Artırma

WordPress çekirdeği varsayılan olarak PHP için 40MB tekil işlem sınırı belirler (yönetim paneli için 256MB). Ancak modern eklentiler ve zengin temalar çalışırken 128MB veya 256MB bellek ihtiyacı duyar. Bellek limitini yükseltmek için WordPress ana dizininde bulunan wp-config.php dosyasını açın ve /* That's all, stop editing! Happy publishing. */ satırının hemen üzerine şu satırları ekleyin:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

Bellek tahsisini resmî standartlara göre düzenlemek için WordPress resmi PHP bellek artırma dokümantasyonu içeriğinden de faydalanabilirsiniz.

Adım 3: Eklentileri ve Temaları FTP / SSH ile Devre Dışı Bırakma

Eğer 502 hatası yönetim paneline (/wp-admin/) erişmenizi engelliyorsa, suçlu eklentiyi tespit etmek için dosya yöneticisi (cPanel / Plesk), FTP ya da SSH kullanmanız gerekir:

• Sunucunuzda /wp-content/ klasörüne gidin.
• plugins klasörünün adını geçici olarak plugins_deaktif şeklinde değiştirin. Bu işlem tüm eklentileri anında pasif hale getirir.
• Sitenizi tarayıcıda yenileyin. Eğer WordPress 502 bad gateway hatası kaybolduysa ve site açıldıysa, sorun kesinlikle bir eklentiden kaynaklanmaktadır.
• Klasör adını tekrar plugins yapın ve içine girerek şüpheli eklenti klasörlerini teker teker yeniden adlandırıp soruna sebep olan eklentiyi izole edin.

Aynı izolasyon adımı gerekirse aktif temanın klasör adı değiştirilerek WordPress’in varsayılan temaya (Twenty Twenty-Four) dönmesi sağlanarak da uygulanabilir.

Adım 4: Nginx FastCGI ve Proxy Zaman Aşımı Ayarlarını Yapılandırma

Nginx, arka uçtaki PHP işleyicisinden yanıt beklerken varsayılan 60 saniyelik limit dolarsa veya yanıt başlığı boyutu tampon belleği taşarsa doğrudan 502 Bad Gateway döndürür. Bu sorunu çözmek için Nginx sanal ana makine (Server Block) yapılandırma dosyanızı (/etc/nginx/sites-available/your-domain.conf) açın ve location ~ \.php$ bloğunun içine aşağıdaki optimize edilmiş parametreleri ekleyin:

# FastCGI Tampon ve Zaman Aşımı Optimizasyonu
fastcgi_buffers 16 16k;
fastcgi_buffer_size 32k;
fastcgi_read_timeout 300s;
fastcgi_send_timeout 300s;
fastcgi_connect_timeout 300s;
proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_busy_buffers_size 256k;

Değişiklikleri kaydettikten sonra sözdizimi doğrulaması yapıp Nginx servisini yeniden yükleyin:

sudo nginx -t
sudo systemctl reload nginx

Nginx yapılandırma direktiflerinin teknik temellerini incelemek için Nginx FastCGI Module dokümantasyonu resmî kılavuzundan detaylı bilgi alabilirsiniz.

Adım 5: PHP-FPM Havuz Parametrelerini Donanıma Göre Ölçeklendirme

Sunucunuzda yeterli RAM olmasına rağmen PHP-FPM havuz sınırları düşük tutulmuşsa siteniz en ufak trafik dalgalanmasında 502 hatasına düşer. Havuz ayarlarını düzenlemek için /etc/php/8.2/fpm/pool.d/www.conf dosyasını düzenleyin:

pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 15
pm.max_requests = 1000
request_terminate_timeout = 300s

Burada pm.max_requests = 1000 değeri, her işçi sürecin 1000 istek işledikten sonra kendini yeniden başlatmasını sağlayarak olası PHP bellek sızıntılarını (memory leaks) otomatik olarak önler.

Adım 6: CDN ve Cloudflare Yapılandırmasını Denetleme

Eğer hata Cloudflare tarafında 502 Bad Gateway Host Error olarak üretiliyorsa aşağıdaki adımları kontrol edin:

• SSL/TLS Modu Uyuşmazlığı: Cloudflare kontrol panelinde SSL/TLS ayarını kontrol edin. Eğer sunucunuzda geçerli bir SSL sertifikası kurulu değilken mod “Full (Strict)” olarak seçildiyse Cloudflare origin sunucuya bağlanamaz ve 502 döndürür. Gerekirse geçici olarak “Flexible” veya “Full” moduna alın.
• Geliştirici Modunu (Development Mode) Açma: Cloudflare önbelleğinin bozuk bir 502 yanıtını önbelleğe alıp ziyaretçilere servis etmesini engellemek için önbelleği tamamen temizleyin (Purge Everything).
• A Kaydı ve IP Yönlendirmesi: Cloudflare DNS sekmesindeki A kaydının doğrudan web sunucunuzun geçerli ve güncel IP adresine işaret ettiğinden emin olun. Sunucu ağ yapınızı ve araçlarınızı denetlemek adına Webmaster araçları rehberi üzerinden DNS ve ağ analiz araçlarını kullanabilirsiniz.

Cloudflare kenar sunucu hataları hakkında daha detaylı troubleshooting adımları için Cloudflare 5xx Hataları Sorun Giderme Rehberi resmî kaynağını inceleyebilirsiniz.

WordPress 502 Bad Gateway Hatasını Kalıcı Olarak Önleme Stratejileri

502 hatasını çözdükten sonra aynı krizin tekrar yaşanmaması için sistem mimarisinde kalıcı dayanıklılık önlemleri almanız şarttır:

• Nesne Önbelleği (Object Cache) Kullanın: Her sayfa açılışında veri tabanına onlarca sorgu göndermek yerine Redis veya Memcached kullanarak veri tabanı yükünü %80 azaltın. Hangi önbellek motorunun sitenize daha uygun olduğunu öğrenmek için Redis vs Memcached önbellek mimarisi karşılaştırması makalemizi inceleyebilirsiniz.
• Sayfa Düzeyinde Tam Önbellekleme (Full Page Caching): Nginx FastCGI Cache veya LiteSpeed Cache devreye alarak statik HTML sayfaları doğrudan RAM üzerinden sunun. Böylece PHP-FPM işçi süreçleri gereksiz yere meşgul edilmez.
• Otomatik Servis İzleme (Process Monitoring): Monit veya systemd watchdog servisleri yapılandırarak PHP-FPM çöktüğü anda sistemin yöneticiden bağımsız olarak servisi 2 saniye içinde otomatik yeniden başlatmasını sağlayın.
• Düzenli Veri Tabanı ve Transient Temizliği: Süresi geçmiş oturum verileri ve geçici transient kayıtları veri tabanını şişirerek sorguların zaman aşımına uğramasına neden olur.

Sıkça Sorulan Sorular (SSS)

WordPress 502 Bad Gateway hatası Google SEO sıralamamı düşürür mü?
Evet. Eğer 502 Bad Gateway hatası birkaç saatten uzun sürerse, sitenizi ziyaret eden Googlebot sayfaları tarayamaz ve indeks listesinden düşürebilir. Arama motorları kesintinin geçici olduğunu anlamak için belirli bir süre tanır ancak 24 saati aşan durumlarda organik sıralama kayıpları kaçınılmazdır.

Tarayıcı önbelleğini temizlemek 502 hatasını çözer mi?
Nadir de olsa tarayıcınız önceki bir bağlantı kopukluğunun hata kodunu yerel belleğinde saklamış olabilir. Ancak vakaların %95’inde 502 hatası tamamen sunucu içi iletişim (Nginx – PHP-FPM) arızasından kaynaklanır ve tarayıcı temizliği sorunu çözmez.

502 Bad Gateway ile 504 Gateway Timeout arasındaki fark nedir?
502 Bad Gateway durumunda ters vekil sunucu arka uçtan geçersiz ya da bozuk bir başlık alır (işlem anında reddedilir veya çöker). 504 Gateway Timeout durumunda ise arka uç sunucusu belirlenen zaman aşımı süresi dolana kadar hiçbir yanıt vermez.

Paylaşımlı hosting kullanıyorum ve sunucu loglarına erişimim yok, ne yapmalıyım?
Paylaşımlı hosting hesaplarında PHP-FPM ve Nginx yapılandırma dosyalarına doğrudan erişiminiz yoktur. Bu durumda wp-config.php üzerinden bellek artırma ve eklentileri FTP ile kapatma adımlarını deneyin. Sorun devam ederse sunucu sağlayıcınıza PHP havuz limitlerini veya upstream yapılandırmasını kontrol etmesi için destek bileti (ticket) açın.

Özet ve Son Değerlendirme

Özetle, WordPress 502 bad gateway hatası korkulacak karmaşık bir gizem değil; doğru adımlarla teşhis edildiğinde kolayca çözülen tipik bir sunucu içi katmanlar arası iletişim kopukluğudur. Rastgele ayarları değiştirmek yerine önce sunucu günlüklerini (error.log) okumak, PHP-FPM havuz sınırlarını donanımınıza uygun şekilde ölçeklendirmek, bellek sınırlarını yükseltmek ve Nginx FastCGI tamponlarını yapılandırmak sitenizi hem mevcut krizden kurtarır hem de gelecekteki yoğun trafik dalgalanmalarına karşı kaya gibi sağlam hale getirir.